home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / printing / 2column6.lzh / 2COLUMNS.DOC next >
Text File  |  1994-01-14  |  28KB  |  642 lines
  1.                   Two Column Printer, Release 6  1/94
  2.                          by Jonathan Corey
  3.  
  4. Distribution:
  5.    FREEWARE - Please include documentation and printer drivers
  6.    with any copies you give out.
  7.  
  8. Language:
  9.    GFA BASIC 3.5E
  10.  
  11. New stuff in Release 6:
  12.    The file README_6.TXT describes new features and enhancements
  13.    in this release.  The major one is the user interface which has
  14.    been "GEMized" to allow better multitasking operation and
  15.    greater flexibility.
  16.  
  17. New users:
  18.    Read the "Introduction" section and then the "Getting Started"
  19.    section below.
  20.  
  21. Old users:
  22.    The readme file should be enough to get you going.
  23.  
  24.  
  25.                -=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-=-
  26.  
  27.  
  28. INTRODUCTION
  29.  
  30. *  What does it do?
  31.  
  32. TWO COLUMN PRINTER prints text files (ASCII) in a two column "magazine
  33. style" format.  This saves paper and makes long listings much easier to
  34. refer to.  To save even more paper, it has an option that simplifies two
  35. sided printing, even on continuous form paper.
  36.  
  37. TWO COLUMN PRINTER works very well with program documentation, source
  38. code listings, bulletin board captures, and "online" magazines.  It's not
  39. designed to do fancy "desktop publishing" work.
  40.  
  41.  
  42. *  What kind of files does it print?
  43.  
  44. ASCII text files.  Basically, these are files that are readable when
  45. displayed by the Desktop SHOW option.  TWO COLUMN PRINTER will warn you if
  46. you try to print the wrong kind of file.  
  47.  
  48. There are several variations in the way text files end lines.  Release 6
  49. can handle the following:  carriage-return/line-feed (Atari & IBM), line-
  50. feed/ carriage-return, line-feed only (unix), carriage-return only
  51. (Apple), and those that don't have any of these in the middle of
  52. paragraphs. 
  53.  
  54.  
  55. *  Will it work with my printer?
  56.  
  57. That's likely.  One of the drivers supplied with the program will work if
  58. your printer is Epson compatible (FX or LQ), is a DeskJet, or can emulate
  59. a HP LaserJet II.  Instructions for writing a driver for other printers
  60. are included in this file.  It's not difficult.
  61.  
  62. Ideally, your printer should be able to print at least 20 characters per
  63. inch (CPI) to get the most out of TWO COLUMN PRINTER.  Standard printer
  64. output is usually at 10 or 12 CPI.  So called "compressed" print is 17
  65. CPI.  Compressed type works fairly well but being able to go to 20 CPI
  66. gives better results with many files.  Not all printers can do this.
  67.  
  68. IMPORTANT:  Some printers (such as the Panasonic KX-P1091i and KX-P1191)
  69. have control panel settings that cannot be changed by software.  TWO
  70. COLUMN PRINTER will not function properly unless they are set to a
  71. programmable mode (the Panasonic KX-P1091i calls this "Std Pgm", the 
  72. KX-P1191 calls it just "Pgm").
  73.  
  74.  
  75. *  What resolutions does it run in?
  76.  
  77. All of them (ST/TT/Falcon and non-standard) as far as I know.  I do not
  78. have the hardware to test all possible displays,  let me know if you find
  79. any that do not work.  Don't use a resolution that shows less than 80
  80. columns of text (e.g. ST low resolution) unless you are familiar with the
  81. program since most of its help screens won't be readable.
  82.  
  83.  
  84. *  What are its memory requirements?
  85.  
  86. Release 6 uses between 260k and 330k bytes plus either enough RAM or disk
  87. space for a work buffer.  The buffer ranges from about 20% larger than the
  88. print file to as much as 75% larger than it.  The bigger one is used with
  89. files that have tabs in them.
  90.  
  91. When TWO COLUMN PRINTER gets over 300k bytes to work with it can do
  92. printouts that require as many as 30,000 lines.  With less than that it
  93. can do up to 15,000 line printouts.
  94.  
  95.  
  96. *  Where can I send comments, questions, bug reports, or thousands
  97.    of dollars?
  98.  
  99. For electronic mail, my GEnie address is JWC-OEO.  
  100.  
  101. For the other kind, write to:  Self-Styled Software, 321 J Street, Sparks
  102. NV 89431.
  103.  
  104. TWO COLUMN PRINTER is free.  No payment is requested.
  105.  
  106.  
  107.              -=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-=-
  108.  
  109.  
  110. GETTING STARTED
  111.  
  112. The first hurdle for new users is the printer driver (see "Will it work
  113. with my printer?" in the introduction section above).  You can start
  114. 2COLUMNS.PRG and check out its drop down menu items but you cannot load a
  115. file until after you choose a printer driver.  Don't worry about "config
  116. files" for now.
  117.  
  118. Several printer drivers are available.  One of them should work well for
  119. you if your printer is "Epson compatible",  a HP Deskjet, or a laser that
  120. can emulate a HP LaserJet II.  If not, you'll have to do some editing. 
  121. See the "Printer Codes and Drivers" section below for instructions.
  122.  
  123. All these drivers are set up for printing on 8 1/2 x 11 inch paper.  You
  124. can make a driver for other sizes if you want (see the "Printer Codes and
  125. Drivers" section below).  Make sure you printer is in its "Epson mode" if
  126. you use an Epson type driver.
  127.  
  128. Here is a list of printer types and associated drivers.  The printer on
  129. which the driver was developed is listed in parentheses, this does not
  130. mean it won't work on other similar printers.  (Pan = Panasonic)
  131.  
  132.  
  133. Printer       Driver(s)      Comments
  134.  
  135. 9-pin Epson   EPSON_FX.DAT   Has a 20 CPI font (Epson FX85)      
  136. compatibles   KX_P1191.DAT   similar, adds 15 CPI font(Pan KXP1191)
  137.               KXP1091I.DAT   no 20 CPI font  (Pan KX P1091i)
  138.               EPSFX_LC.DAT   LC=Long Columns (124 lines) (FX85)
  139.  
  140. 24-pin Epson  EPSON_LQ.DAT   Generic LQ driver with 20 CPI font
  141. compatibles                    (Epson 1050 & 950)
  142.  
  143. HP DeskJets   DJ_BASIC.DAT   Internal 6 & 12 point fonts, pre 500
  144.               DJ_500.DAT     similar, has 6 & 12 point Letter
  145.                                Gothic fonts as well as Courier
  146.               DJ_GOTHC.DAT   9.5 point font from Ltr Gothic card
  147.               DJ_PE.DAT      10 point font from Prestige Elite card
  148.  
  149. LaserJet II   LJ2BASIC.DAT   Internal fonts, mainly 8.5 point "line
  150. compatibles                    Printer",  (HP LaserJet II)
  151.  
  152.   
  153. After you load a printer driver, the next step is to run through the items
  154. in the "Help" drop-down menu.  Follow that with some short printouts to
  155. test your printer driver (start with single sided printouts).  Print the
  156. "Readme" file and after you get that working okay, print this file and
  157. read them.  When you are reasonably satisfied with a printer driver,
  158. choose the "Merge printer driver" option so it will become the default and
  159. won't have to be loaded each time you run TWO COLUMN PRINTER.
  160.  
  161. After you have used TWO COLUMN PRINTER for a while, you'll likely find
  162. that most of your printing is done with one particular font and one set of
  163. format and print settings.  You can set it up so that these setting are
  164. the defaults (the ones that first appear in the control dialog).  There is
  165. an item under the "Help" menu that explains how to do this.
  166.  
  167.  
  168.              -=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-=-
  169.  
  170.  
  171. MORE FEATURES, DETAILS, AND SOME TECHNICAL STUFF
  172.  
  173.  
  174. *  Automated Operation (Batch file,TOS,TTP,CLI,Shells)
  175.  
  176. In addition to running as a full GEM program TWO COLUMN PRINTER also can
  177. be run as a TTP type program and as a TOS program through a CLI shell. 
  178. There are no prompts for user input when it's used this way, the various
  179. format and print options are set with a configuration (config) file.  The
  180. "command line" for this needs to be in the following form:
  181.  
  182.           FILE.TXT #config.CFG -R
  183.  
  184. FILE.TXT - The file you want to print (the drive/full path needs to
  185.         given if it's not the default).  Only one file at a time
  186.         can be specified.
  187.  
  188. #config.CFG  - (optional) "#" indicates that the name of a config
  189.         file follows.  If no config file is included, 2COLUMNS.PRG
  190.         tries to find a file named "2CL.CFG" by looking first in
  191.         the print file's path and then in the default path.  This
  192.         This same routine is followed with config files that don't
  193.         include a path (print file path first, then default path). 
  194.  
  195. -R   -  (optional) tells 2COLUMNS to return directly to the calling
  196.         program when it's done.  The default is to wait for a key
  197.         press.
  198.  
  199. The "manual paper feed" mode does not work in "automated operat